LOG_FIELDS

SoftwareShield Web-Activator > Web-Activator Communication > Web-Activator Configuration File Specifiers > LOG_FIELDS

## LOG_FIELDS

You should already have a good understanding of Web-Activator Communication and Web-Activator Configuration File Usage.

The LOG_FIELDS parameter specifies a list of comma separated fields (identified by name) which indicate which fields should be logged to the log file.

The log file is a delimited text file. Each line in the file corresponds to one request received by the Web-Activator. Each field on the line is separated by a delimiter. The delimiter is controlled by LOG_SEPARATOR. This allows you to import the log file into your favourite spreadsheet program.

###### Behaviour:

- If a field is not to be logged (is not specified), its column will still appear in the log file but will contain no data. This allows you to change the state of the fields logged without recreating the log file and still be able to consistently import the file into a spreadsheet.

###### Allowable Values:

May be any of the following separated by commas. The order of the fields logged is always the same (as presented below). Also, the log file will always include a collumn header for each field, even if the data itself is not logged.

- REQ_DATE_TIME
  Date / Time of request

- REFERER
  The URI of the resource where the HTTP request message originated.

- REMOTE_HOST
  URI value for back-links to the source of the request.

- REMOTE_ADDR
  The IP address of the source of the Web client request.

- GENCODE_PARAM
  The full GenCode parameter value passed.

- FULL_QUERY
  The full (entire) query string passed. This allows you to parse any data later which is not explicitly logged as a separate field. Be cautious logging this field since you may be receiving a great deal of data.

- AUTHCODE_REQ_ID
  The Authorization Request Code embedded in the GenCode parameter. For example, if the GenCode parameter was: "t=*F*LicenseFileV1.lpj*C*ED19-FBCD-EEB6-D0D0*P*0", then this field would log: "ED19-FBCD-EEB6-D0D0".

- RESP_STATUS
  Brief string summarizing the outcome of the operation if an error occurred. This field is generally only written if an error occurred during processing. This string provides more feedback for your development team in the case of an error. Especially in the case where no response is even be returned. Possible values that might be logged include, but are not limited to:

Not enough parameters were parsed from the query
No response was sent. The Web-Activator was invoked with an unrecognized method.
The specified parameter identifier \"%s\" was not passed in the query.
One or more of the required delimiters were missing from the GenCode composite parameter. Possible missing delimiters are: *F*, *C*, *P* or *DT*.
The specified license project was not found on the server.
The specified license project used an unrecognized file type. Type must be .LPJ
The provided Authorization Request Code was invalid (format).
An Activation Code was not sent. You are attempting to use the Web-Activator with a version of SoftwareShield which does not include its use. You are not licensed for this product. Please contact SoftwareShield regarding upgrading.
The provided authorization request code did not represent a valid Authorization Request Code ID in the specified license project.

- RESPONSE
  The content of the response sent (not including the template text). Only the portion replaced into the <#ACTCODE> tag is logged. Only valid responses (when an Activation Codes is generated) are logged. See the RETURN_TEMPLATE field for more info.

- ALL
  Logs all fields above.

###### Default:

- ALL

###### Examples:

- LOG_FIELDS=ALL

- LOG_FIELDS=REQDATETIME, GENCODE_PARAM, RESPSTATUS, RESPONSE